﻿                           ________________________
                          | |__|__|__|__|__|__|__| |
                          |__/O O\____________/O\|_|
  
                            Long Travel Bus Service

                                    By WTLS




ABOUT THIS TXT:

This txt content:
- Description,
- Requirements,
- Known issues and their solutions,
- Installation,
- How to use,
- Changelog,
- Credits,
- Notes.





DESCRIPTION:

In GTA 5, the majority of players travel by car, legally acquired or 
requisitioned from a passerby, or by taxi, even if this has a cost, but few are 
those who think of public transport. It must be said that only the tram is an 
option accessible in the game as a passenger: the only means of taking the bus 
are to hold the wheel ... or to climb on the roof.

This mod brings bus service for long travel to both counties (LS and Blaine 
county).
It's also a touristic bus that goes to important touristic places in the two counties.

Features:
- Passenger mode (as client) and Driver mode,
- Phone contacts,
- Ability to skip to next stop or a specific stop (fast travel),
- Ability to carry bicycle,
- Bus display in bus stops (shows the name of the bus stop, bus lines with 
  direction and how many stops left for the bus to come) and in bus (shows the
  line with the direction and next stops),
- Show blip in map of the coming bus when in a bus stop,
- Controller support,
- Many customizable options in the settings file,

Features Premium (Extra features for supporter only): 
- Skip Waiting (if you don't want to wait for the bus to come),
- Dashound Navigator 2.0: an app for route planning you use to know what 
  possibilities you have to go to a location.
  Its features: Ability to know what bus to take (transit possibility)
  without using the bus map, only by placing a waypoint in the map and calling Dashound Navigator. It calculates automatically transit possibility and shows you a hint 
  indicating which bus to take and when to stop or change the bus.

Advantages of LTBS Driver Mode than Bus Simulator V:
- Loop working (you can go for other trip once you finish a previous one, the mission doesn't stop showing you the big message "mission complete").
- You can change the line without the need to go to Dashound Bus Center.
- You can go Off Duty / On Duty.
- You work with other buses, you see other active buses in the city, you are not the only bus driver.





REQUIREMENTS:

- ScriptHookV,
- ScriptHookVDotNet.
- NativeUI (included),
- iFruitAddon2 (included),





KNOWN ISSUES AND SOLUTIONS:

Bus doesn't care about you and doesn't wait or you to get in,
> increase "WAITTIME" in the ini file.

Doesn't show more than one blip in the map.
> get further from the stop of the bus that you don't want to see it's blip and closer
  to the stop of the bus that you want to see it's blip.

Path issues like when the bus blocks somewhere or doesn't move,
> skip track by pressing context.

Bus drivers drive like a maniac,
> welcome to Los Santos xD.

- Other?
> Report on #bugs-report channel on discord server. If it's a script error, include the text inside "ScriptHookVDotNet.txt" file in GTA5 main directory after trying the fix of reloading scripts in game.






INSTALLATION:

Put "Coach2.dll", "Coach2.ini", "NativeUI" and "iFruitAddon2" in "scripts" folder.
Put "Coach2" folder!!! in "scripts" folder.
If you have BusSimulatorV installed you must install
one of the 2 packages using OpenIV, so:
Choose your option:
- LTBS LCD Signs: implements the LCD signs and keeps the varied liveries from BSV. It has an issue that the LCD sign covers a little the view in the first person view
- LTBS Vanilla model: it doesn't have the issue of the LCD sign.
Open OpenIV and click tools then package installer then choose the downloaded package ("LTBS.oiv" or "LTBSV.oiv") OR right clic the downloaded package and open with OpenIV, install in 
"Mods" folder.





HOW TO USE:

Passenger mode:
When you go next to a bus stop press context or your custom display key for a display
to appear indicating which lines are available in this current bus stop.
Press your default enter/exit vehicle to enter bus when door 
is opened, press many times if the player doesn't want to enter.
When you are in bus a display will appear indicating next bus stops.
Press context to skip track if you want. If SKIPTOSPECIFICSTOP enabled, choose the stop
to skip to using phone keys left and right and select with phone select. If
SKIPTOSPECIFICSTOP disabled, you will skip to the next stop.
To carry bike with you just exit it and enter bus normally.
Make your custom bus stop wait time in "WAITTIME" in half seconds.

Driver mode:
To be a bus driver go to Dashound Bus Center and you will find a bus bliped in the map, Dashound Bus. Get in it and a menu will pop up to choose what line to work in.
While you are a bus driver you can call Dashound Workforce in phone contacts to pop up a menu with different options, the menu is self-explanatory.





CHANGELOG:

3.2.1:
- Added License Verification System.

3.2: 
- Added option to set custom payout after finishing Bus Driver mission,
- Door can be opened only if the bus is fully stopped Driver Mode,
- Added option to set volume of announcements,
- Added option to disable bus display in bus,
- Fixed some buses come without door,
- Other fixes and improvements.

3.1.1 alpha:
- Fixed NullReferenceException error.

3.1:
- Added bus stops voice announcements,
- Added bus stop markers Driver Mode,
- Fixed peds wrapping out Driver Mode,
- Fixed swapping lines Driver Mode,
- Fixed and improved skipping stops,
- Fixed weird bus floated,
- Other fixes and improvements.

3.0.1:
- Fixed Driver Mode bus not spawning,
- Fixed bugs of peds entering bus,
- Fixed route show only when doors are opened,
- Fixed peds screaming when entering bus,
- Fixed buses disapear,
- Other fixes and improvements.

3.0:
- Added driver mode,
- Added phone contacts,
- Added controller support,
- Fixed bus flipped or floated,
- Fixed skip track bugs,
- Removed the hint "No buses available in this moment",
- Improved Bus Display,
- Improved hints,
- Other fixes and improvements.

2.3.1:
- Fixed NullReferenceException error,
- Other fixes and improvements.

2.3:
- Added Bus Display,
- Fixed custom key not working,
- Line D2 route fix. 

2.2 beta:
- Added line D2 (beta).

2.1:
- Added skip to a specific stop and not stop by stop.

2.0:
- rewrote script,
- added ability to skip to next stop (fast travel),
- added ability to carry a bicycle,
- added hint display,
- added bus fare ($15),
- added enable/disable despawn unused buses,
- added enter bus with default enter vehicle key,
- added custom enter key,
- added custom driving style,
- added custom bus speed in the ini file,
- added custom bus stop wait time,
- improved bus stopping,
- added a fix for NullReferenceException script error,
- added respawn bus if it has been exploded or driver is dead,
- fixed script error,
- fixed two buses spawned in the same area (bus flipped),
- fixed clients don't enter bus,
- fixed one client stays on the bus in terminal station,
- fixed npc vehicles hit the bus from behind,
- fixed player enter bus (now just press one time),
- fixed same bus line spawn back to back,
- fixed bus blocked and doesn't move,
- fixed bus moving while in bus stop,
- fixed not all buses are spawned,
- fixed animals enter bus (not yet in LSBS 2.4.2),
- fixed bus blocked in some bus stops (not yet in LSBS 2.4.2),
- fixed bus floating after skiping to next stop (not yet in LSBS 2.4.2),
- fixed path issues,
- fixed bus color (now all buses are white with Dashound livery),
- other fixes.

1.0 beta:
- first release.





CREDITS:

- Alexander Blade.
- Crosire.
- t1a2l.
- Devs of NativeUI and iFruitAddon.




NOTES!:

The Driver Mode is not an imitation of Bus Simulator V, the feature is unique and has nothing to do with BSV.

This mod has been made after a long work and lot of fixing of annoying things 
like NPC's stupidity.

Do not reupload and steal our work!

Enjoy!

                                        WTLS